home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / distri~1 / updates / incobj30.zoo / level30.zoo / usr / lib / readme.bin < prev   
Encoding:
Text File  |  1993-02-22  |  2.9 KB  |  71 lines
  1. This archive contains the compiled MiNT libraries.
  2.  
  3. To use these libraries, you need the corresponding set of include
  4. files.
  5.  
  6. This archive does not contain the curses or PML libraries.  I may
  7. include them in the future if and when I get my act together.
  8.  
  9. Bug reports go to:  entropy@terminator.rs.itd.umich.edu
  10.  
  11. Cheers,
  12. entropy
  13.  
  14. Eric's original readme follows:
  15.  
  16. ========================================================================
  17.  
  18. To use the MiNT library enclosed herein, you will need the MiNT
  19. include files (see mntinc25.zoo). The MiNT include files should
  20. be compatible with the "standard" gcc include files, but provide
  21. some definitions that are true only if __MINT__ is defined. As
  22. shipped, __MINT__ is always defined. If you would prefer to compile
  23. with the "normal" gcc libraries most of the time, then the following
  24. steps are necessary:
  25.  
  26. (1) Copy all the files in mntinc25.zoo into your include
  27.     directory, overwriting the old include files where
  28.     applicable.
  29. (2) Comment out the definition of __MINT__ in the include file
  30.     compiler.h.
  31. (3) Rename the gnu.olb and gnu16.olb from this library to mint.olb
  32.     and mint16.olb, respectively; and rename crt0.o and gcrt0.o to
  33.     mcrt0.o and mgcrt0.o respectively.
  34. (4) Use gcc's -mint flag to link with the MiNT library.
  35.  
  36.  
  37. Personally, I use the MiNT libraries for everything (replacing the gcc
  38. libraries entirely) since 99% of the functions also work under TOS,
  39. and the 1% that don't are things like fork() and pipe() that one
  40. wouldn't really expect to work in a single-tasking OS. However,
  41. everyone seems to have their own preferences on this matter.
  42.  
  43. A couple of other points: the files that have names starting with 'b'
  44. are compiled with the -mbaserel flag which is supported by Howard Chu's
  45. version of gcc 2.2.2.
  46.  
  47. Also: you may notice that there's no termcap.olb or termcap16.olb. That's
  48. to save space; the files in the termcap library are already in the curses
  49. library, so you can simply copy (or better yet, make a symbolic link from)
  50. curses.olb to termcap.olb, bcurses.olb to btermcap.olb, etc.
  51.  
  52. There are no docs; I recommend getting the source code (see mntlib25.zoo)
  53. and using that. The documentation for the gcc library applies to a
  54. lot of this library, too, so you could get that; and a good book on
  55. Unix and ANSI C programming would help a lot, since the library is mostly
  56. ANSI and Posix compatible.
  57.  
  58. The library is based on the gcc library that Jwahar Bammi and I put together.
  59. Lots of people have contributed to it, including (but not limited to):
  60.  
  61. Adrian Ashley, Jwahar Bammi, Scott Bigham, Kai-Uwe Bloem, Howard Chu,
  62. John R. Dunning, Doug Gwyn, Dave Gymer, Michael Hohmuth, Alan Hourihane,
  63. Alex Kiernan, Ulf Moeller, Allan Pratt, Arnold D. Robbins, Edgar Roeder,
  64. Rich Salz, Dale Schumacher, Andreas Schwab, Eric Smith, Henry Spencer,
  65. and Stephen Usher.
  66.  
  67. I've hacked on things quite a bit, so if they're broken don't blame the
  68. original authors, blame me.
  69.  
  70. Eric R. Smith
  71.